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C]1AR PLOT 
Michael Spetinsf 


CHAR PLOT is a r^utisne which enables one Co use the CalCo^p plotter as a 
versatile output device, It is presently available 56 CHPLOT BIN (English 
CHAR PLOT) on tape US 3, 
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The pro gran CKAH PhffE is normally celled by a TU5HJ ?, PLGTC with a 
Code representing a command at character (as. defined in Appendix I) ia 
accumulator C 4 Upon calling:, the routine will either plot a character or 
line, or perform an internal control function, A D code initialilea the 
routine, erasing any unexecuted {buffeted) commands,. 

{Starred portions of thl* nemo., explain the items necessary to use 
the routine for most purposes. Other portions describe more (less needed) 
options,] 


*eh£ calcoms plotter 

The CalComp platter is an incremental xy plotter which is capable of 


horiaoncal 

and vertical 

lficretLeciting by ,QG5 inch. 

1 no re merit log can be dune 

s eparat ely 

{±1, i j) nr 

together Ciiij) T where t end j ace unit (.00? inch) 

vectors in 

the +X. and directions, respectively. 

Thus 3 directions of 
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[Hote that 
this creates 
a right-hand 
coordinate 
system en 
the paper.} 


edges o-f paper- 
_JLO,5 inches_ 
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->- 


plotter V - axis 
(direction of pen motion 


plotter X-axis 
(direction of 
paper motion) 




2 . 

Mote that the plotter has 2.0 iffiy of detecting where the pen is with respect 
Eo tht paper- -Lir. cotton requested past; the edge of die paper £* Ignored 
by the- plotter, but this shoul-d not be relied upon far esat-t posit ion lag, 

tOQHVEHTIQWS 

Radices,. All Integers are octsl^ aLl other numbers are decimal. 

Relative units, 1 relative unit = SCALE * 1 absolute unit {.COS inch), 
Characters are plotted id relative uni'Es ar-d vectors may also be so plotted, 

Directions and Apparent Ane$. the apparent axes fftay be set in one of 
eight possible orientations with respect to the plotter axes (see Appendix T, 
codes 30 - 37) T Directions (R,D>L,11,[JR h EJL,DL,DR) ere with respect to the 
apparent axes unless otherwise specified, 

Parentheses around a symbol mean "contents of", 

*GiaEAL SY1JS0L5 

ftOTC [formal entry point. 

CHARFL Entry point which treats the B low-order hits of accumulator 

C as a character code regardless of the rest of accumulator C, 

CCTAU beginning of upper-case table. 

LtTAE beginning of lower-case table (-“200+C-CTAE). 

CLMFI3J Routine (called by RUSH! b, CLKGTR) which returns in C the 

length (in relative an Its) of the tioit-ccn trol character whose 
code wa$ its argument in C. Upper and lower case can be 
spCtifltd using the 2CM3 bit o£ by celling COGIH with 16 and 17 
codes to change case, 

JC? Current coordinates of pen in absolute units with respett to the 

L - apparent axes. Initially (X)-(Yj=0. Kot initialised by 0 Code, 

SCALE Humber of absolute units C,0U5 Inch) id a relative, unit, 

Characters ere always plotted in relative unics* and vectors 
say be so plotted. 



lj 

—■* 


user- 
defined 





> . --1 
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TUaCation for return frou. crock Lr.terrupc. 

See 3EFIHE CHAR command (With the transfer hit I,.,,), 


Crock PI channel. (Is CEUOIH.^ 7) 

Length of data buffers. Unless othtrwia* specified they are 
both 1000, IlMtnr, they msy be as Little as 1 each, 
C^LBUFF^LWKJFF, otherwise storage is vested. LETJFF^OOMO. 

Push-down pointer, (IsPalT) 

At strict,t accumulator. (lsC$L7) 

For plotting a character, the input to thd fc-atitt* is a word whose 8 
low-order bits contain an ASCII-type code (see Append Is I) and whoae sign 
hit sust be 0.. For a normal character, the pen la assumed to be raised and 
is left raised; the character ij plotted with its lower iefc cornet at the 
initial position Ot thn pan, ahd th£ pon is left ready for plotting the nt*t 
character. 

Characters may he in upper or Lower cast, The cise of a character is 
specified in one of two ways; codes 26 and 17 may bo used to shift to eg, 
character codes being interpreted in the current case; Or_ while the routine 
is in upper case, the 2Qfl hit of a character code may be 0 cr t tC specify 
upper or lower ease,. respectively. Kate that when jn Lower case, character 
cooes should have the 200 hit 0. The program starts Ln upper case (initiallied 
by 0 code) and it is suggested that the 200 bit be used to specify case rather 
than shifting case vjlth the Li and 17 codes. 

*VECTDkS AKD CQ^TkOL FUHCILOHS 

For plotting vectors and for performing control functions„ the input to 
the routine is a word whose sign bit is 1. The high-order bits of this word 
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are interpreted as follows: 
bit 0^ 

10 xy-format. 

110 Refine CHAR/CKilL SEX. 

1110 Go to effective address at process time with all 
accumulators restored to their valve before the last 

intatnift, (to return to char plot u s e just iMCttoraT'O 

1111 Half-word format. 


*XY-yORMAT 

bits: 
x and 
The code is 
00 



y are interpreted as 2C , -‘-fcic 2'a eaxplement nunbera. 
interpreted as followsi 

Set CH) and CY). Set 00 to x and (Y) to y. 


01 


10 


1L 


Does not move pex. 

Increment £.x>y) with scale. Move the pen as specified 
by the vector SCALE* (x,y)* i.e. x relative unite R 
and y relative units U. 

Increment (x, y) without scale. Move the pen as specified 
fey the vector (x,y) , 3,*e. k absolute units R and y 
absolute units 3. and y absolute units I). 

Go to {^,y) t Move the ?en to the paint (x. 


with 

pen 

down 

vect 

is 

plot 


DE-FIME CHAl/CttAR 
felts: 


SET 


012A _ 11 _ 1.3. _ _ 22_43 

110 | pointer transfer hie j character coda | address 


If the transfer hit Is 0, the address and pointer refer to a word and 
position within the word of the first four-hit byte of the character to be 
specified by the character code* They are placed in the proper positions of 
1 byte pointer which then defines the character. The byte-length is sot to 
four automatically. The word or words containing the bytes arc set up ns 



5 , 


follows; 


|a*WI i l - - - |o E 

Irn and Ay are respectively the changes in LX) and in (Y) produced by pLotting 
the characterj measured in tel stive units, They are interpreted as positive 
4-bit quantities, Richer or both o*y he Thu first 0- after Qt( and Ay 
terminates the string.. The codes for bytes are as fuliaws: 

1 Pen Up 

4 Pen Down 

5 Dot Down (plots a dot at current pen position) 

LG Right one relative unit 

11 Up ona relative unit 

12 Left one relative unit 

13 Down one relative unit 

14 HR 

13 UL 

16 DL 

17 DR 

With the transfer hit 1 4 the pointer hits are placed as in a byte pointer, 
bit 14 is set to l h the address remains> and resulting word defines the charac¬ 
ter to be specified by the character code, l/hen the character ia usedj, the 
routine transfers tothe address (without dismissing the interrupt) with the 
character-defining word remaining in accumulator C, Retvrr-s to CHAP PLOT 
supplied are HEWC (continue)„ 5FEC (which plots the character whose defining 
word is in accumulator C, then continues}, and SETW (which interprets th* word 
in accumulator C as If it were an at gun-ent to PLDTC with hit 0 ■ 1, then 
continues). SCALE, X, atvd Y at a global and go can he iBOdified and/or taaced 
befora recutn, in addition, if the user defines a global symbol ?P <e locacion 
contal-nLng a special push-down pointer} , he ray call a subroutine SUSPLT which 
works like PLDTC, only in interrupt mode h and thus performs thv command which 



its argvaient ImAedlacely. An example ■$£ Ile ll^^; would be: 


EJtCH P N PP 
MOVE C, [WED 13 
PUSHJ F, SU£PLT 
MOVE C t (W0ED2] 

PUSEJ P, SLTEPLT 
EXCE F, PP 
J^ST HEW 

Thu EJKEt P, PP J.nitrwCtioTls ate necessary since 5H3FLT also executes 
these ins emotions before JisfcisStag the interrupt and before returning to 
the calling program. 

Thus a new character may be defined. Once defined, the character -may be 
used in the normal manner. 

The Define CStAK SET fcatore enables the nser to define a complete set of 
Characters, The S hits for Character code being 0 specify this feature. The 
address is that location which is the beginning of s character table of word# 
defining characters, with the first location defining the character with code 
0, the second defining code 1, etc. Once a set is so defined, it is the only 
one addressable, lo order to return to the original set, one may use a Define 
CHAR SET with UOTAB as th* address. 


"HALF-WORD FORMAT 
hits: 


01234_ 

if 11 ] onu sed ! 


17 22 43 


cod 



The code is interpreted as follows; 

U Set scale to n, 

1 Bet horizontal tsh to ei. This sets tabs at n N 2n h on, etc. 

f l□ be interpreted in relative units}. Initially 40. 

Set line feed length to n £to- be interpreted in relative 
units}. Initially set fox single space at 9. 


2 



7. 


2 

4 

5 

6 
7 


Set vertical tab, (lik* botl^ontal cab) 
Set (X) to 

Set {Y) to nJ ti interpreted £2-tit 
Go to (X)=n r f 2 r s complement isuaber. 
Go to CY)=n, 
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"rbTTlAI- CHASACTES. SET 


code 

0 

1 

2 

3 

4 

5 

6 
1 

10 

11 

12 

13 

14 

15 

16 
17 
20 
21 
22 

23 

24 

25 

26 
11 

30 

31 

32 

33 

34 

35 

36 

37 


upp-er casc/Jwcf case (add 200 to cede if in upper cast) 
(if no entry, sane as upper ■Case) 
illegal character/illegal character if in Lower case 
pen down 
Subscript 
pen up 
superscript 

eater itode with no pen controls executed 
leave mode uldi no pen controls executed 


seF scale to zero (1 is first usable scale) 
tvoFiiObtal tab 
line feed 

vertical tab (will not go past 3 page boundary) 
form feed (pages are 4000 absolute units long) 
carriage return 
shift into upper case 
shift into lower case 
add 2C to scale/subtract 2^ from scale 
add 2^ to scale/sub tract 2 *- from scale 
add 22 to scale/subtract 2^ from scale 
to stale/subtract 2 . from stale 
to scale/subtract 2^ froci scale 
to ^cale/subtract 2 . from scale 
to Ecale/suhtract 2^ fren stale 
to scale/subtrait 2 * from scale 
orient apparent x-exls along plotter *-axis 
orient apparent vs-swis along plotter y-axia ^ 
orient apparent x-axis upside down along plotter 1-4*iS 
orient apparent x-axts upside down along plotter y-axis 
orient apparent >e-axl$ backwards along plotter x-axis 
orient apparent x-axis backwards along plotter y-ails 
orient apparent x-axis upside down and backwards nlong 
plotter x-axis JJ 

orient apparent x^axis upside down 4nd backwards along 
plotter y-aXiS 

JiJote that when one of the codes 30-37 is executed, (X) 

(¥) are changed. The point (20D0.20Q0) 1* a fixed point in 
this transformation,! 


sdd 

add 

add 

add 

add 


2 4 

2 4 

2 l 

2 6 

2? 


f 

r 

t 


and 



r 


L 
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code 

upper case 

40 

4“unit spate 

41 

! 

42 

■r 

43 

£ 

44 

$ 

45 

% 

46 

6 

47 

1 

50 

t 

51 

> 

52 

* {asterisk} 

53 

+ 

54 

¥ 

55 

- {minus} 

56 

B 

57 

f 

60 

0 

61 

1 

63 

2 

63 

3 

64 

4 

65 

5 

66 

6 

67 

7 

70 

S 

71 

9 

72 

■ 

73 

£ 

74 


75 

m 

76 


77 

S 

LOO 

G 

itu 

A 

102 

B 

103 

C 

104 

P 

105 

£ 

106 

F 

107 

C 

110 

>1 

111 

1 

112 

J 


icrLTet" cage 
3-UTiit space 


C 


* (superscript asterisk) 
- (hyphen) 


A 

it 

B. 

h 

c 

d 

e 

f 

a 

h 

1 







10 , 


CUCe 

dipper case 


lover case 

113 

K 


It 

114 

L 


I 

ns 

M 


m 

116 

71 


n 

117 

0 


o 

120 

p 


p 

121 

0 


<] 

m 

R 


r 

121 

$ 


a 

124 

T 


t 

125 

n 


u 

126 

V 


V 

127 

tf 


V 

130 

X 


K 

131 

Y 


y 

132 

133 

z 

[ 


± 

134 

135 

\ 

] 


l (no horizontal spacing) 

13t 

t 


f 

137 

-H 



140-157 

not used 



160 

R one relative 

uni t 

R one absolute unit 

161 

U one relative 

unit 

U one absolute unit 

162 

1 cns relative 

unit 

h aue absolute unit 

163 

I> one relative 

unit 

E one absolute unit 

164 

cm awe*(relative: 

on it 

US one^absolute unit 

165 

UL one ft relative 

unit 

UL one^absolute unit 

165 

DL oofi*relative 

unit 

DL one s shsolute unit 

167 

170 

171-177 

DDl nne*relative 
DC 

not used 

on it 

DR one*absolute unit 


^actually yT - jnits 
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SUMMARY 07 COMMANDS 




bit; 


bit; 


bit; 


bic: 


0 


34 43 

E 

imuaad 

cede ! 


01 2 22 14 43 


10 

K 

QO 

y 

id 

fiK 

01 

iy 

TjETI 

iK - ' 

“nr- 

iy 

*2tr 

X 

IT 

y 


CHARACTER, 


SET {X) Abl> <T) 
IKCBEMEEvT V/ SCALE 
INCHEHEKT VOUL SCALP 
CO TO 6: F y) 


on 

3 

11 

12 

22 43 

110 

pointer 

c,b. 

code 

;i£df Li.v:-; 

u a 

nftLiried 

“0-1 

address 

01234 

4 

15 16 

22 

_1L 


I 1110 unused E 7 | X I add7ea7| GQ TO 


DEFINE CHAitACTER 
DEFIflE CHAR SF~T 


EPF. ADDRESS 


0153 _4_1 1 _ 2243 


1111 

unused 

0Q0 

n ! 

1111 

emus ad 

001 

u | 

1111 

unujed 

“BID 

ft 

mi 

lines ed 

Oil 

ft 

mi 

unused 

100 

fL 

ini 

unused 

101 

11 

mi 

unused 

110 

n 

i'in 

unused 

U1 

sra 


SET SCALE 
SET KOR, Tnb 
EEL' LIUE V EPS 
SET VSJtT. TATJ 
SET 00 
SET (Y) 

CO TO U)=n 
GO TO <Y>-n 




